<!DOCTYPE html>
<html lang="en" dir="ltr" class="client-nojs">
<head>
<meta charset="UTF-8" />
<title>Fulla - PanoTools.org Wiki</title>
<meta http-equiv="X-UA-Compatible" content="IE=EDGE" />
<meta name="generator" content="MediaWiki 1.23.6" />






<style media="screen" type="text/css" title="Screen style sheet"> @import url(manual.css); </style>

<style>a:lang(ar),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}
/* cache key: panotools_wiki:resourceloader:filter:minify-css:7:90730a7865ba4b50e0b837e1821ff0a3 */</style>



<!--[if lt IE 7]><style type="text/css">body{behavior:url("/skins/vector/csshover.min.htc")}</style><![endif]--></head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-Fulla skin-vector action-view vector-animateLayout">
		
		
		<div id="content" class="mw-body" role="main">
			<a id="top"></a>
			
						<h1 id="firstHeading" class="firstHeading" lang="en"><span dir="auto">Fulla</span></h1>
						<div id="bodyContent">
								<div id="siteSub">From PanoTools.org Wiki</div>
								
												
				<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><p><b>fulla</b> is a command-line tool distributed with <a href="Hugin.html" title="Hugin">hugin</a>. It can correct chromatic aberration, lens distortion, and vignetting.
</p>
<div id="toc" class="toc"><div id="toctitle"><h2>Contents</h2></div>
<ul>
<li class="toclevel-1 tocsection-1"><a href="Fulla.html#About_fulla"><span class="tocnumber">1</span> <span class="toctext">About fulla</span></a></li>
<li class="toclevel-1 tocsection-2"><a href="Fulla.html#Command-line_usage"><span class="tocnumber">2</span> <span class="toctext">Command-line usage</span></a></li>
<li class="toclevel-1 tocsection-3"><a href="Fulla.html#Notes"><span class="tocnumber">3</span> <span class="toctext">Notes</span></a></li>
<li class="toclevel-1 tocsection-4"><a href="Fulla.html#Windows_batch_usage"><span class="tocnumber">4</span> <span class="toctext">Windows batch usage</span></a></li>
<li class="toclevel-1 tocsection-5"><a href="Fulla.html#External_links"><span class="tocnumber">5</span> <span class="toctext">External links</span></a></li>
</ul>
</div>

<h2><span class="mw-headline" id="About_fulla">About fulla</span></h2>
<p>fulla is suitable for batch correction of:
</p>
<dl>
<dt><a href="Chromatic_aberration.html" title="Chromatic aberration">Chromatic aberration</a></dt>
<dd> See tutorial in <a href="Fulla.html#External_links">external links</a>.
</dd>
<dt><a href="Lens_correction_model.html" title="Lens correction model">Lens distortion</a></dt>
<dd> <a href="Barrel_distortion.html" title="Barrel distortion">Barrel</a> or <a href="Pincushion_distortion.html" title="Pincushion distortion">pincushion distortion</a> can be corrected using the same a, b, c and d parameters as other Panorama Tools<a class="external" href="http://wiki.panotools.org/Panorama_Tools">[*]</a> derived programs.
</dd>
<dt><a href="Vignetting.html" title="Vignetting">Vignetting</a></dt>
<dd> Polynomial correction by division, addition or flatfield images. <a href="Hugin.html" title="Hugin">hugin</a> contains a vignetting calculator that can use a series of overlapping photographs to determine the likely polynomial required to correct common vignetting problems.
</dd>
</dl>
<p>fulla can work with the same range of image types as <a href="Nona.html" title="Nona">nona</a>, including 8bit and 16bit <a href="TIFF.html" title="TIFF">TIFF</a> and 32bit floating-point <a href="HDR.html" title="HDR">HDR</a> TIFF data.
</p>
<h2><span class="mw-headline" id="Command-line_usage">Command-line usage</span></h2>
<p>Usage: 
</p>
<pre>  fulla [options] inputfile(s)
</pre>
<p><br />
The following options can be specified:
</p>
<ul>
<li> <tt>--green=db|a:b:c:d</tt> or <tt>-g db|a:b:c:d</tt>
</li>
</ul>
<p>Correct radial distortion for all channels. Specify 'db' for database lookup or the 4 coefficients a:b:c:d.
</p>
<ul>
<li> <tt>--blue=db|a:b:c:d</tt> or <tt>-b db|a:b:c:d</tt>
</li>
</ul>
<p>Correct radial distortion for blue channel, this is applied on top of the <tt>--green</tt> distortion coefficients, use for TCA corr. Specify 'db' for database lookup or the 4 coefficients a:b:c:d.
</p>
<ul>
<li> <tt>--red=db|a:b:c:d</tt> or <tt>-r db|a:b:c:d</tt>
</li>
</ul>
<p>Correct radial distortion for red channel, this is applied on top of the <tt>--green</tt> distortion coefficients, use for TCA corr. Specify 'db' for database lookup or the 4 coefficients a:b:c:d
</p>
<ul>
<li> <tt>--camera-maker=Maker</tt> or <tt>-m Maker</tt>
</li>
</ul>
<p>Camera manufacturer, for database query
</p>
<ul>
<li> <tt>--camera-model=Cam</tt> or <tt>-n Model</tt>
</li>
</ul>
<p>Camera name, for database query
</p>
<ul>
<li> <tt>--lensname=Lens</tt> or <tt>-l Lens</tt>
</li>
</ul>
<p>Lens name, for database query. Specify <tt>--camera-maker</tt> and <tt>--camera-model</tt> for fixed lens cameras or <tt>--lensname</tt> for interchangeable lenses.
</p>
<ul>
<li> <tt>--focallength=50</tt> or <tt>-d 50</tt>
</li>
</ul>
<p>Specify focal length in mm, for database query
</p>
<ul>
<li> <tt>--aperture=3.5</tt> or <tt>-a 3.5</tt>
</li>
</ul>
<p>Specify aperture for vignetting data database query
</p>
<ul>
<li> <tt>--dont-rescale</tt> or <tt>-s</tt>
</li>
</ul>
<p>Do not rescale the image to avoid black borders.
</p>
<ul>
<li> <tt>--flatfield=filename</tt> or <tt>-f filename</tt>
</li>
</ul>
<p>Vignetting correction by flatfield division: I = I / c, c = flatfield / mean(flatfield)
</p>
<ul>
<li> <tt>--vignetting=db|a:b:c:d</tt> or <tt>-c db|a:b:c:d</tt>
</li>
</ul>
<p>Correct vignetting (by division). Specify db for database look up or the the 4 coefficients a:b:c:d: I = I / ( a + b*r^2 + c*r^4 + d*r^6)
</p>
<ul>
<li> <tt>--linear</tt>
</li>
</ul>
<p>Do vignetting correction in linear color space
</p>
<ul>
<li> <tt>--gamma=value</tt> or <tt>-i value</tt>
</li>
</ul>
<p>Gamma of input data. used for gamma correction before and after flatfield correction
</p>
<ul>
<li> <tt>--help</tt> or <tt>-h</tt>
</li>
</ul>
<p>Display help
</p>
<ul>
<li> <tt>--output=name</tt> or <tt>-o name</tt>
</li>
</ul>
<p>Set output filename. If more than one image is given, the name will be uses as suffix (default suffix: _corr)
</p>
<ul>
<li> <tt>--compression=value</tt> or <tt>-e value</tt>
</li>
</ul>
<p>Compression of the output files. For jpeg output: 0-100, For tiff output: PACKBITS, DEFLATE, LZW
</p>
<ul>
<li> <tt>--offset=X:Y</tt> or <tt>-x X:Y</tt>
</li>
</ul>
<p>Horizontal and vertical shift
</p>
<ul>
<li> <tt>--verbose</tt> or <tt>-v</tt>
</li>
</ul>
<p>Verbose output
</p>
<h2><span class="mw-headline" id="Notes">Notes</span></h2>
<p>Finding the correct lens correction parameters can be done using several approaches (see <a href="Lens_correction_model.html" title="Lens correction model">Lens correction model</a> and external links for details). Note parameter d for radial distortion (default 1.0) is not available in GUI frontends - the d mentioned in frontends is typically a different parameter related to image shift.
</p>
<h2><span class="mw-headline" id="Windows_batch_usage">Windows batch usage</span></h2>
<p>Once you have calculated fulla parameters as described above, you can create a custom <i>droplet</i>
for batch correcting photos like so:
</p>
<ul>
<li> Create a <i>Shortcut to fulla.exe</i> by dragging the <i>fulla</i> icon to another directory in Windows explorer
</li>
<li> Edit <i>properties</i>
</li>
<li> Change the <i>target</i> to include your correction parameters:
</li>
</ul>
<pre> "C:\Program Files\hugin\fulla.exe" --red=0:0:0.00056:1.00015 --blue=0:0:-0.00026:1.0011 --vignetting=1:0.20:-0.51:0.2
</pre>
<ul>
<li> Rename the shortcut to something descriptive like <i>fulla-peleng</i>
</li>
<li> Now you can correct photos by dragging and dropping them onto the icon
</li>
</ul>
<h2><span class="mw-headline" id="External_links">External links</span></h2>
<ul>
<li> <a rel="nofollow" class="external text" href="http://hugin.sourceforge.net/tutorials/tca/en.shtml">Correcting TCA with hugin and fulla</a>
</li>
<li> <a rel="nofollow" class="external text" href="http://sourceforge.net/project/showfiles.php?group_id=77506&amp;package_id=187932">PTLens database download</a> (April 2006)
<ul>
<li> <a rel="nofollow" class="external text" href="http://lensfun.berlios.de/">Lensfun</a> <a rel="nofollow" class="external text" href="http://svn.berlios.de/wsvn/lensfun/trunk/data/db/">SVN</a> includes parameters for many more lenses
</li>
</ul>
</li>
<li> <a rel="nofollow" class="external text" href="http://lensfun.berlios.de/lens-calibration/lens-calibration.html">How to determine lens correction parameters</a> - from Lensfun documentation
</li>
</ul>




</div>								<div class="printfooter">
				Retrieved from "http://wiki.panotools.org/index.php?title=Fulla&amp;oldid=15710<a class="external" href="http://wiki.panotools.org/index.php?title=Fulla&amp;oldid=15710">[*]</a>"				</div>
												</div></div></body></html>